home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / man1 / iforncs / lb_admin.1 < prev    next >
Encoding:
Text File  |  1998-10-30  |  17.1 KB  |  331 lines

  1.  
  2.  
  3.  
  4. LB_ADMIN(1)               User Commands               LB_ADMIN(1)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      llllbbbb____aaaaddddmmmmiiiinnnn - Location Broker Administrative Tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////eeeettttcccc////nnnnccccssss////llllbbbb____aaaaddddmmmmiiiinnnn [ ----nnnnqqqq ] [ ----vvvveeeerrrrssssiiiioooonnnn ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The llllbbbb____aaaaddddmmmmiiiinnnn tool administers the registrations of NCS-based
  16.      servers  in  Global  Location Broker (GLB) or Local Location
  17.      Broker (LLB) databases.  A server registers Universal Unique
  18.      Identifiers  (UUIDs)  specifying  an  object, a type, and an
  19.      interface, along with a socket address specifying its  loca-
  20.      tion.   A  client  can  locate  servers  by  issuing  lookup
  21.      requests to GLBs and LLBs.  Using the llllbbbb____aaaaddddmmmmiiiinnnn tool, you can
  22.      look  up  information,  add new entries, and delete existing
  23.      entries in a specified database.
  24.  
  25.      The llllbbbb____aaaaddddmmmmiiiinnnn tool is useful for inspecting the  contents  of
  26.      Location   Broker  databases  and  for  correcting  database
  27.      errors.  For example,  if  a  server  terminates  abnormally
  28.      without  unregistering itself, you can use llllbbbb____aaaaddddmmmmiiiinnnn to manu-
  29.      ally remove its entry from the GLB database.
  30.  
  31.      In accepting  input  or  displaying  output,  llllbbbb____aaaaddddmmmmiiiinnnn  uses
  32.      either  character  strings  or  descriptive textual names to
  33.      identify objects, types, and interfaces.  A character string
  34.      directly  represents  the  data  in  a  UUID  in  the format
  35.      _x_x_x_x_x_x_x_x_x_x_x_x...._x_x...._x_x...._x_x...._x_x...._x_x...._x_x...._x_x...._x_x, where each _x is a hex-
  36.      adecimal  digit.   Descriptive  textual names are associated
  37.      with UUIDs in the uuuuuuuuiiiiddddnnnnaaaammmmeeee....ttttxxxxtttt file.
  38.  
  39.      With llllbbbb____aaaaddddmmmmiiiinnnn, you examine or modify only one database at  a
  40.      time,  which  we  refer  to  as  the  The uuuusssseeee____bbbbrrrrooookkkkeeeerrrr command
  41.      selects the type of Location Broker database,  GLB  or  LLB.
  42.      The  sssseeeetttt____bbbbrrrrooookkkkeeeerrrr  command  selects  the host whose GLB or LLB
  43.      database is to be accessed.  Of course, if  you  modify  one
  44.      replica  of  a  replicated  GLB database, your modifications
  45.      will be propagated to the other replicas of that database.
  46.  
  47.      On Apollo systems, llllbbbb____aaaaddddmmmmiiiinnnn presents both a  Domain/Dialogue
  48.      window-oriented   user  interface  and  a  terminal-oriented
  49.      interface.   On  other  systems,  it   presents   only   the
  50.      terminal-oriented   interface.    Here   we   describe   the
  51.      terminal-oriented interface to llllbbbb____aaaaddddmmmmiiiinnnn.  For information on
  52.      the Domain/Dialogue interface, use the HELP key or the right
  53.      mouse button, or see _M_a_n_a_g_i_n_g _N_C_S _S_o_f_t_w_a_r_e.
  54.  
  55. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  56.      ----nnnnqqqq        Do not query for verification of wildcard  expan-
  57.                sions in uuuunnnnrrrreeeeggggiiiisssstttteeeerrrr operations.
  58.  
  59.      ----vvvveeeerrrrssssiiiioooonnnn   Display the version of  NCK  that  this  llllbbbb____aaaaddddmmmmiiiinnnn
  60.  
  61.  
  62.  
  63. NCS Administration        Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LB_ADMIN(1)               User Commands               LB_ADMIN(1)
  71.  
  72.  
  73.  
  74.                belongs to, but do not start the tool.
  75.  
  76. CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  77.      In llllooooooookkkkuuuupppp, rrrreeeeggggiiiisssstttteeeerrrr, and uuuunnnnrrrreeeeggggiiiisssstttteeeerrrr  commands,  the  _o_b_j_e_c_t,
  78.      _t_y_p_e,  and  _i_n_t_e_r_f_a_c_e  arguments  can  be  either  character
  79.      strings representing UUIDs or textual names corresponding to
  80.      UUIDs, as described earlier.
  81.  
  82.      aaaa[dddddddd]     Synonym for rrrreeeeggggiiiisssstttteeeerrrr.
  83.  
  84.      cccc[lllleeeeaaaannnn]   Find and delete obsolete entries  in  the  current
  85.                database.
  86.  
  87.                When you issue this command, llllbbbb____aaaaddddmmmmiiiinnnn attempts  to
  88.                contact  each  server  registered in the database.
  89.                If the server responds, the entry for  its  regis-
  90.                tration  is  left  intact in the database.  If the
  91.                server does not respond, llllbbbb____aaaaddddmmmmiiiinnnn tries to look up
  92.                its  registration  in the LLB database at the host
  93.                where the server is located, tells you the  result
  94.                of  this  lookup,  and  asks  whether  you want to
  95.                delete the entry.  If a server responds,  but  its
  96.                UUIDs  do  not  match  the  entry in the database,
  97.                llllbbbb____aaaaddddmmmmiiiinnnn tells you this result  and  asks  whether
  98.                you want to delete the entry.
  99.  
  100.                There are two situations in  which  it  is  likely
  101.                that a database entry should be deleted:
  102.  
  103.                +o  The server does not respond, llllbbbb____aaaaddddmmmmiiiinnnn  succeeds
  104.                  in  contacting  the  LLB  at  the host where the
  105.                  server  is  located,  and  the  server  is   not
  106.                  registered  with  that LLB.  The server is prob-
  107.                  ably no longer running.
  108.  
  109.                +o  A server responds, but its UUIDs do  not  match
  110.                  the  entry  in  the  database.   The server that
  111.                  responded is not the  one  that  registered  the
  112.                  entry.
  113.  
  114.                Entries that meet either of these  conditions  are
  115.                probably  safe to delete and are considered eligi-
  116.                ble for (described in  the  next  paragraph).   In
  117.                other  situations,  it  is  best not to delete the
  118.                entry unless you  can  verify  directly  that  the
  119.                server is not running (for example, by listing the
  120.                processes running on its host).
  121.  
  122.                When llllbbbb____aaaaddddmmmmiiiinnnn asks whether you want to  delete  an
  123.                entry,  you  have  four  ways to respond.  A yyyy[eeeessss]
  124.                response  deletes  the  entry.   A  nnnn[oooo]  response
  125.                leaves  the entry intact in the database.  After a
  126.  
  127.  
  128.  
  129. NCS Administration        Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LB_ADMIN(1)               User Commands               LB_ADMIN(1)
  137.  
  138.  
  139.  
  140.                yyyyeeeessss or a nnnnoooo, llllbbbb____aaaaddddmmmmiiiinnnn proceeds to check  the  next
  141.                entry  in  the  current database.  A gggg[oooo] response
  142.                invokes automatic deletion, in which all  eligible
  143.                entries are deleted and all ineligible entries are
  144.                left intact, without your being queried, until all
  145.                entries have been checked.  A qqqq[uuuuiiiitttt] response ter-
  146.                minates the cccclllleeeeaaaannnn operation.
  147.  
  148.      dddd[eeeelllleeeetttteeee]  Synonym for uuuunnnnrrrreeeeggggiiiisssstttteeeerrrr.
  149.  
  150.      hhhh[eeeellllpppp] [_c_o_m_m_a_n_d] or ???? [_c_o_m_m_a_n_d]
  151.                Display a description of the specified _c_o_m_m_a_n_d or,
  152.                if  none  is  specified,  list all of the llllbbbb____aaaaddddmmmmiiiinnnn
  153.                commands.
  154.  
  155.      llll[ooooooookkkkuuuupppp] _o_b_j_e_c_t _t_y_p_e _i_n_t_e_r_f_a_c_e
  156.                Look up and  display  all  entries  with  matching
  157.                _o_b_j_e_c_t,  _t_y_p_e, and _i_n_t_e_r_f_a_c_e fields in the current
  158.                database.  You can use asterisks as wildcards  for
  159.                any  of  the  arguments.  If all the arguments are
  160.                wildcards, llllooooooookkkkuuuupppp displays the entire database.
  161.  
  162.      qqqq[uuuuiiiitttt]    Exit the llllbbbb____aaaaddddmmmmiiiinnnn session.
  163.  
  164.      rrrr[eeeeggggiiiisssstttteeeerrrr] _o_b_j_e_c_t _t_y_p_e _i_n_t_e_r_f_a_c_e _l_o_c_a_t_i_o_n _a_n_n_o_t_a_t_i_o_n [_f_l_a_g]
  165.                Add the specified entry to the  current  database.
  166.                You  can use an asterisk to represent the nil UUID
  167.                in the _o_b_j_e_c_t, _t_y_p_e, and _i_n_t_e_r_f_a_c_e fields.
  168.  
  169.                The  _l_o_c_a_t_i_o_n  is   a   string   in   the   format
  170.                _f_a_m_i_l_y::::_h_o_s_t[[[[_p_o_r_t]]]], where _f_a_m_i_l_y is an address fam-
  171.                ily, _h_o_s_t is a host  name,  and  _p_o_r_t  is  a  port
  172.                number.   Possible  values  for _f_a_m_i_l_y include ddddddddssss
  173.                and iiiipppp.  You can use a leading #### to indicate  that
  174.                a  host name is in the standard numeric form.  For
  175.                example, ddddddddssss::::////////ssssaaaallllzzzzbbbbuuuurrrrgggg[[[[555511115555]]]], ddddddddssss::::####555577775555dddd....555544442222eeee[[[[444455552222]]]],
  176.                iiiipppp::::vvvviiiieeeennnnnnnnaaaa[[[[1111777755556666]]]],  and  iiiipppp::::####111199992222....5555....5555....5555[[[[1111777799991111]]]] are all
  177.                acceptable _l_o_c_a_t_i_o_n specifiers.
  178.  
  179.                The _a_n_n_o_t_a_t_i_o_n is a string of up to 64  characters
  180.                annotating  the entry.  Use double quotation marks
  181.                to delimit a string that contains a space or  con-
  182.                tains  no characters.  To embed a double quotation
  183.                mark in the string, precede it with a backslash.
  184.  
  185.                The _f_l_a_g is either llllooooccccaaaallll (the default) or  gggglllloooobbbbaaaallll,
  186.                indicating  whether the entry should be marked for
  187.                local registration only  or  for  registration  in
  188.                both  the  LLB  and  GLB databases.  The _f_l_a_g is a
  189.                field that is stored with the entry; it  does  not
  190.                affect   where   the  entry  is  registered.   The
  191.                sssseeeetttt____bbbbrrrrooookkkkeeeerrrr  and  uuuusssseeee____bbbbrrrrooookkkkeeeerrrr  commands  select  the
  192.  
  193.  
  194.  
  195. NCS Administration        Last change:                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LB_ADMIN(1)               User Commands               LB_ADMIN(1)
  203.  
  204.  
  205.  
  206.                particular LLB or GLB database for registration.
  207.  
  208.      ssss[eeeetttt____bbbbrrrrooookkkkeeeerrrr] [_b_r_o_k_e_r__s_w_i_t_c_h] _h_o_s_t
  209.                Set the host for the current LLB or GLB.   If  you
  210.                specify  gggglllloooobbbbaaaallll  as  the _b_r_o_k_e_r__s_w_i_t_c_h, sssseeeetttt____bbbbrrrrooookkkkeeeerrrr
  211.                sets the  current  GLB;  otherwise,  it  sets  the
  212.                current  LLB.   The _h_o_s_t is a string in the format
  213.                _f_a_m_i_l_y::::_h_o_s_t, where _f_a_m_i_l_y is an address family and
  214.                _h_o_s_t  is  a host name.  Possible values for _f_a_m_i_l_y
  215.                include ddddddddssss and iiiipppp.  You can use a  leading  ####  to
  216.                indicate  that  a  host  name  is  in the standard
  217.                numeric   form.     For    example,    ddddddddssss::::////////lllliiiinnnnzzzz,
  218.                ddddddddssss::::####444499999999dddd....555599990000ffff,  iiiipppp::::pppprrrraaaagggguuuueeee,  and iiiipppp::::####111199992222....5555....5555....5555 are
  219.                all acceptable _h_o_s_t specifiers.
  220.  
  221.                Issue uuuusssseeee____bbbbrrrrooookkkkeeeerrrr, not this command,  to  determine
  222.                whether  subsequent operations will access the LLB
  223.                or the GLB.
  224.  
  225.      sssseeeetttt____tttt[iiiimmmmeeeeoooouuuutttt] [sssshhhhoooorrrrtttt | lllloooonnnngggg]
  226.                Set the timeout period used by llllbbbb____aaaaddddmmmmiiiinnnn for all of
  227.                its  operations.   With  an  argument  of sssshhhhoooorrrrtttt or
  228.                lllloooonnnngggg, sssseeeetttt____ttttiiiimmmmeeeeoooouuuutttt sets  the  timeout  accordingly.
  229.                With  no argument, it displays the current timeout
  230.                value.
  231.  
  232.      uuuu[nnnnrrrreeeeggggiiiisssstttteeeerrrr] _o_b_j_e_c_t _t_y_p_e _i_n_t_e_r_f_a_c_e _l_o_c_a_t_i_o_n
  233.                Delete the specified entry from the current  data-
  234.                base.
  235.  
  236.                The  _l_o_c_a_t_i_o_n  is   a   string   in   the   format
  237.                _f_a_m_i_l_y::::_h_o_s_t[[[[_p_o_r_t]]]], where _f_a_m_i_l_y is an address fam-
  238.                ily, _h_o_s_t is a host  name,  and  _p_o_r_t  is  a  port
  239.                number.   Possible  values  for _f_a_m_i_l_y include ddddddddssss
  240.                and iiiipppp.  You can use a leading #### to indicate  that
  241.                a  host name is in the standard numeric form.  For
  242.                example, ddddddddssss::::////////ssssaaaallllzzzzbbbbuuuurrrrgggg[[[[555511115555]]]], ddddddddssss::::####555577775555dddd....555544442222eeee[[[[444455552222]]]],
  243.                iiiipppp::::vvvviiiieeeennnnnnnnaaaa[[[[1111777755556666]]]],  and  iiiipppp::::####111199992222....5555....5555....5555[[[[1111777799991111]]]] are all
  244.                acceptable _l_o_c_a_t_i_o_n specifiers.
  245.  
  246.                You can use an  asterisk  as  a  wildcard  in  the
  247.                _o_b_j_e_c_t,  _t_y_p_e,  and  _i_n_t_e_r_f_a_c_e fields to match any
  248.                value for the field.  Unless you  have  suppressed
  249.                queries  by invoking llllbbbb____aaaaddddmmmmiiiinnnn with the ----nnnnqqqq option,
  250.                uuuunnnnrrrreeeeggggiiiisssstttteeeerrrr asks you whether to delete each  match-
  251.                ing entry.  A yyyy[eeeessss] response deletes the entry.  A
  252.                nnnn[oooo] response leaves the entry in the database.  A
  253.                gggg[oooo]   response  deletes  all  remaining  database
  254.                entries that match, without your being queried.  A
  255.                qqqq[uuuuiiiitttt]  response  terminates the uuuunnnnrrrreeeeggggiiiisssstttteeeerrrr opera-
  256.                tion, without deleting any more entries.
  257.  
  258.  
  259.  
  260.  
  261. NCS Administration        Last change:                          4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. LB_ADMIN(1)               User Commands               LB_ADMIN(1)
  269.  
  270.  
  271.  
  272.      uuuussss[eeee____bbbbrrrrooookkkkeeeerrrr] [_b_r_o_k_e_r__s_w_i_t_c_h]
  273.                Select the type of database that subsequent opera-
  274.                tions  will access, GLB or LLB.  The _b_r_o_k_e_r__s_w_i_t_c_h
  275.                is either gggglllloooobbbbaaaallll or llllooooccccaaaallll.  If you do not supply a
  276.                _b_r_o_k_e_r__s_w_i_t_c_h,   uuuusssseeee____bbbbrrrrooookkkkeeeerrrr   tells   whether  the
  277.                current database is global or local.
  278.  
  279.                Use sssseeeetttt____bbbbrrrrooookkkkeeeerrrr to select the host whose GLB or LLB
  280.                is to be accessed.
  281.  
  282. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  283.      _M_a_n_a_g_i_n_g _N_C_S _S_o_f_t_w_a_r_e
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. NCS Administration        Last change:                          5
  328.  
  329.  
  330.  
  331.